Labels: text | screenshot | document | black and white OCR: Malgro de nombreux wacune erreur, VOUS UTILISEZ pourrai en aucun cas Rtre indirect, resultant de l'uti Introduction AMoff est un program ARoff est un progranne de formatage de texte puissant et complet, wwec registres, macros, etc. la fois le texte et les conn ! il prend en entroe un fichier conprenant la fois le texte et les connandes de fornatage, et produit en sortie le texte mis en page conne vous AMoff peut être considero comme une sorte de portage de l'utilitaire AMoff peut être com "nroff", que l'on trouve habituellement SOUS Bustine UNIX. Les dexx rogrannes sout cependant assez differents, et il y a sdrenent beaucoup de choses que ARoff ve sait pas faire. La syntaxe d'appel de MRoff est la suivante 1 aroff [-upile] [-1] (non de fichier) (non de fichier> est le mon du fichier que vous voulez Indiquez "-" conne non, l'entrée standard sera utilisde. traiter, SI vous La version actuelle de ARoff correctement si elle est utilisée en sortie de pipe (e.g. ne peut fonctionner "cat toto | aroff -"). L'option -u vous permet d'augmenter la taille de la pile de travail alloube par fåoff. Par dofaut cette taille est de 256 emplacements de 8 octets chacun, mais il peut arriver que cela ne suffise pas obtiendrez alors un message "Error 2 in file pile.c at live SU", Pour faire VOWS asser la taille de la pile . 300 emplacements (par exemple), appelez ARoff par "aroff -w300 <non de fichier>". Si vous indiquez l'option -1. le fichier d'entre sera charge entifrenent em monoire avant d'être traite. Sur Aniga, ceci peut rendre le traitement deux & trois fois plus rapide dans certains cas, mais est & doconseiller si vous avez peu de nonoircalibre. Si vous appelez ANoff sans arguments tou avec des arguncats Incorrects) vous obtiendrez un message indiquant la version da progranne et sajntaxe « respecter pour les arguments, Comne "sroff", MRoff assemble automatiquenent les lignes obtenir une ligne suffisamment longue. Cela veut dire que votre texte texte est un conse une suite de mots que ARoff se contente de recopier, jusqu's ce que la taille d'une ligne de sortie soit atteinte, os que vous provoquicz la fim de l'assemblage (soit par une requête, soit par une ligne vide), Les requêtes suluantes provoquent automatiquement une fin de l'assemblage ! nouvelle page nouvelle ligne Manuel de roference centre la(les) ligne(s) suivante(s) activation du node "assemblage" dosactivation du mode "assemblage" saut de ligne Indentation Indentation temporaire Une fois cette ligne assemblee, ARoff effectue un ajusteneut, saluant le node que vous avez indiquo ; centrage, justification, cadrage droite ou & gasche. Le resultat constitue une ligne de sortie. Les commandes de formatage (ou requêtes) doivent être indiquées ser une ligne & part, consentant par un point. Le nom de la requête suit Innidiatenent, et fait exactement deux caracteres. Viennent ensuite les ryancats Queatuels de la requite. Pour utiliser une des requêtes ci-dessus sans provoquer de fin d'assemblage, utilisez le caractère "quote simple" la place du point (e.g. : "ti -" au lieu de ",tl -3"). 4. Liste des requêtes courantes Dans tout ce qui suit, M dosigne um entier positif, et IN designe soit un entier positif (specification d'une valeur procise), soit le signe plus suivi d'un entier positif (specification d'une incrementation), soit enfim le signe moim suivi d'un entier positif (specification d'une docrOnentation). lah ABort Description : affiche le message indiquo, wide le tampon de sortie Syntaxe : ab message et termine. Begin Page Syntaxe Description : provoque un saut de page. La page suivante bp (N) numero M si un argument est indique. aura le Theak Description : provoque un saut de ligne, L'assenblage de 1 Syntaxe br courante est interrompu, et cette ligne ligne SANS a justenent . est inprince CEnter Syntaxe Description : centre la ligne suluante, ou les M lignes suivantes si i ce (N) un argument est indiqub. Syntaxe Description : ulde le tampon de sortie et termine. Santaxe Description : active l'assemblage des lignes. Mamel de reference Tage 3 Description : modifie le style des caractores. La chaine "style" est Syntaxe ! fs style une combinaison quelconque des specifications suivantes fin de caractires gras retour wax caractores Bornaux IMdent Description : change la marge gauche. Sans argument, la waleer Syntaxe In 1H1 peticideste est reprise. 11 Line Length Description I change la longueur des lignes de sortie (indentation Syntaxe comprise). Sans argument, la valeur procedente est reprise. Line Spacing Syntaxe Description : change l'espacenent des lignes de sortie. Sans argument, la valeur peocidente est reprise. It Title Length Description : change la longueur du titre (voir requite "LI"). Sam Syntaxe argument, la valeur procedente est reprise. Mo Adjusting Syntaxe Description : dosactive l'ajustement des lignes en sortie. Description : me mundrote pas les M lignes saluantes, ou la ligne Syntaxe sintering suivante si aacas argument m'est indique. ARaft Manuel de reference Page 4 Page Length Description : change le nombre de lignes par page. Sans argument, la Syntaxe valeur par dofast est reprise. Page Hunber Syntaxe Description : change le numero de la prochaine page. i pn IN po Page Offset ! po (M1 Description : change la marge gauche pour Syntaxe (airforent de l'Indentation), Sans argument, la valeur procedente tout document est reprise. Source so fichier Description : imere le contenu da fichier indique. Syntaxe sp SPace Syntaxe Description : Insore M (1 par dofaut) lignes blanches. Tabu lation Description : positionne les arrêts de tabulations aux colonnes Syntaxe : ta H N+1, 2M-1, etc ... te Tab Character Syntaxe Description ! indique le caractive & utiliser lors de l'extension I te fel des tabulations, Sans argument, la waleur par dofaut est reprise. Temporary Indent Description : Indeste la ligne suivante de la valeur indique. Syntaxe Title Description : inprinc un texte en trois parties : "a" est cadro Syntaxe 1 tl 'a'b'e' gauche, "b" est centro, et "c" est cadro & droite. N'importe quel caractore peut Être utiliso pour soparer les trois parties, et ou deux parties peuvent Stre uldes. ta Ternimal Message : tm message Description : affiche le message indique. Syntaxe tr TRans late Syntaxe I tr abed ... Description I indique une conversion en sortie : a est change en c est chango en d, etc ... Si un nombre impair de caracteres est indiquo, le dernier sera chango en un espace. Title Style Description : Indique le style de caracteres Syntaxe : ts str du titre. w' importe quelle combinaison de : est passage en gras passage en italiques passage em souligne Manuel de roforence Page 5 5. Le fornat des lignes ARoff reconnait les comtraction saluantes ; M tabulation Vespace) \newline> espace fixe retour & la ligne & Ignorer le reste de la ligue est un comentaire le reste de la ligue est & lire sans aucune Interpretation, et & envoyer la sortie sans ajustement (ne peut Être utiliso qu'es 00but de ligne) Insorer la valeur d'un registre insorer la valeur d'une chaine Il vous est tres vivement comeillo de ne pas mettre de tabulation dam votre texte 1 utilisez plutft la stquence "\t". Les registres permettent de stocker des valeurs nunoriques entières. In manipule les registres « l'aide des requêtes suluantes ! New Register Syntaxe me non ual [inc] Description : cree le registre "non" et lui done la valeur initiale "ual". Si l'argument "inc" est indique. il est memorise conne saleer de l'incronent du registre. Le nom peut faire un ou deux caracteres. Les arguments "ual" et "inc" sont des entiers positifs. Remove Register Syntaxe : Fr non Description : dotruit le registre "non". "utilisation des registres se fait de la namitre suivante : imatre la valeur du registre x incromente puis insire la valeur da registre > docromente puis insire la valeur da registre x Mexx insire la valeur du registre xx 9/14 Lxx An-Lxx incromente puis iasire la valeur du registre xx docromente puis imstre la valeur du registre xx Les registres sulvants sont pro-dofinis par ARoff : jour de la semaine (1 « 7) jour du mois (1 < 31) nois (1 . 12) ande (deux chiffres) minoro de la page courante (en sortie) mindro de la ligne courante (en sortie) nunbro de la ligne courante (en entroe) Notez que les registres donnant la date et l'heure sont initialises une fois La suite. pour toutes lors de l'initialisation de ARoff, et ne sont pas nis « jour par Les chaines permettent de stocker des chaines de caractires d'au lus 255 caractives. On manipule les chaines & l'aide des requêtes aluantes Hamel de roforence Page 6 ds Define String Syntaxe da non chaime Description : croc une chaine de non indique, et lui affecte wileur "chaine". Pour comserver les espaces en dobut de chaine, suffit de mettre un guillenet wwwnt le premier espace. Le non peut faire un ou deux caracteres. Si la chaine "non" existe doje, ANoff se contente de changer sa wsleur. Append String Syntaxe : as non chaime Description : ajoute la chaine indique « la chaine "som". Cette chaine est cride si elle w'existe pas. Pour conserver les espaces en dobut de chaine, il suffit de mettre un guillenet avant le premier espace. TE Remove String Description : dotruit la chaine Indiquee. Syntaxe : rE non Les chaines s'utilisent de la manière suluante : ivatre la valeur de la chaine x imatre la valeur de la chaine xx La chaine "In" est dofinie automatiquenent par ARoff, et contient le non fichier en cours de traitement. 6, Les macros Les macros permettent de stocker et de rappeler facilenest une serie de regultes et/ou un grand morceau de texte. On manipule les macros & l'alde des requittes saluantes ; de DEfine macro Syntaxe Description [ commence la definition de la macro "non". Si cette I de non macro existe do je, son contem est efface. Les lignes saluantes sont momorisdes en tant que dofimition, jusqu's ce qu'une ligne commence par " .. " (deux points). Description : ajoute les lignes suluantes ( jusqu'g ce qu'une Syntaxe an non ligne Commence par " .. ") e la definition de la macro macro n'existe pas, elle est crede. cette BonQUE MacTO Syntaxe Description : dotruit la macro indiqube. In non Print Macro Syntaxe Description : affiche la definition de la macro indique, ou i pm [macro] de toutes les macros si ancas argument w'est spécifie. registre "."". Le soparateur d'arguments est l'espace. Si vous voulez passer un argument conprenant un espace, ajoutez un "\" devant cet espace, 51 voulez passer un argument comprenant un espace fixe, ajoutez trois euaut cet espace. ARoff Hamel de reference Page 7 HOTE IMPORTANTE 1 Lors de la lecture de la dofinition d'une macro, texte est interproto de la wine faton que d'habitude, Pensez donc « doubler les "\" devant les appels de registres, de chaines ou d'arguments, si vous voulez difforer leur interpretation « l'extcution de la macro. Contrairenent & "veoff", il est d'interdit d'inclure une requête ".de" .an" dam une definition de macro. L'appel d'une macro par une autre est ossible. . Les trappes Les trappes permettent de doclencher l'exocution d'une macro certaine position verticale dans la page. C'est avec ce wicanione que peut ajouter une en-tête ou un pied-de-page. On manipule les trappes l'aide des requêtes saluantes : wh Description I place une trappe & la ligne indique. La macro extcatte Syntaxe I uh ligne non sera la macro "non". S'il y avait doje une trappe & cette position, AMoff se contente de changer le non de la macro & extcuter. S "ligne" est negatif, il s'agit d'une position relative & la fin de la page. 5l "ligne" est mul, la trappe est doclenchde en fin page. Remove Trap Description : enlove la trappe placte & la ligne indiqube. Syntaxe i rt ligne HOTE IMPORTANTE 1 Dans la version actuelle de ARoff, la trappe de fin de page n'est jamais doclenchoe sur la deraitre page de texte. Lorsque ARoff est sur le point d'Ocrire une ligne, Il regarde si wie trappe st plache sur cette ligne. Si oui, il appelle la macro indique wwwnt tenter & nouveau d'Ocrire la ligne. fonctionnenent permet doc lenchenent en cascade de trappes placoes sur des lignes combeatives. AMoff permet de rendre conditionnelle l'exécution d'une requite ou A'une macro, ou bien encore l'insertion d'une portion de texte. On manipule les conditions & l'aide des requêtes suluantes : Syntaxe if cond reste Description Ignore le reste de la ligne si la condition w'est pas verifide. Description : Ignore le reste de la ligne si la condition testoe par Syntaxe I el reste le "if" procodent Otait verifide. La requête "el" doit sulure IMMEDIATEMENT La requête "If". Le format des conditions est le suivant : la page courante est de numero inpaire la page courante eat de numero pair le formateur est "aroff" (toujours val) Manuel de reference Page 8 "chl'ch2" On peut inverser une condition, en la faisant proceder par "exclamation "!". Les arguments des tests peuvent bien entendu point registres ou des chaines. Voici quelques exemples 1 Qtre des if o .tl 'Entete de page impaire"'satpn' .el .tl 'Entete de page paire''sa(po' .If "sm(fw'macros" le fichier nacros .el an autre fichier \" Sant de page si la ligne d'entrée est > 56 if wa( il>56 . bp sont insoros dans le texte an fur et cesare de sa lecture, On peut utiliser un registre ou une chaine conne d'une requête. Un registre inconnu a une valeur Ogale & zoro, une chaise inconnue est remplace par mme chaine vide. Une requête Income entrainera la recherche d'une macro. L'appel d'une macro non dofinie sera A la différence de "proff", les registres, chaines et macros sont onservOs dans des listes differentes. Cela veut dire que vous pouvez domer le wine von & un registre, « une chaine et & une nacro : il n'y aura aucune cafusion, Par contre, come la liste des requêtes est parcourse wwwnt la liste des macros, si une macro et wne requinte ont le wine non, C'est equate qui sera extostle. Voici la liste des codes d'erreurs indiques par ARoff : erreur interne pile vide pile pleine erreur de syntaxe dobordeneat de table ou de tampon ouverture de Fichier impossible arguments incorrects erreur d'Ocriture plus de monoire libre requikte "el" non procidee par une requête "if" inpossible de se doplacer dam le fichier erreur de lecture dans le fichier & traiter le fichier & traiter est vide Voici les valeurs par dofaut des parandtres de mise en page ! ajusteneut Indentation Longueur des lignes espaceneat des lignes longueur des titres Is longueur des pages nunero de page narge gauche tabu lation de roforence M. GOUNELLE Denis Boite 71 6, rue des cailloux "12110 CLICHY - FRANCE Alloff a 0to doveloppe presque entifrenent sous mystone UNIX, puis ecompile sur finiga avec l'Aztec C 3.6a. Les fichiers sources sont fourals il w'y a pas beaucoup de commentaires, 00sol0 1), avec les "makefile" pour mix et pour fiztec. Ce programme devrait pouvoir Atre compilo sams trop roblones par n'importe quel compilateur C. Les parties spécifiques onpilateur fuetec C sont plactes entre "Hifdef". 0. Historique 1.00 06-Sep-91, 22114 octets Treniare version diffusoe. 1.01 20-Oct-31, 22524 octets Ajout de la requête "Is". Ajout de la chaine "SUER:" pour la commande Version (03 2.0). 1.02 11-Mou-91. 22736 octets. Ajout de la requête "Ls". Correction d'une erreur dans la mundrotation des pages (connentalt = 2 au lieu de 1). 13-Mou-91, 22076 octets Plusieurs optimisations (6x plus rapide d'agels "prof", consonne moins de monoire). 14-Mou-91. 24020 octets La pile interne est maintenant alloute correctement 1 depuis le dobut on allouait (TaillePile = 2) octets au lieu de (TaillePile 8), d'o- des plantages avec de gros fichiers sources. Ajout des requêtes "if" et "el". La fonction Pop() me dopilait janais le dernier Ol0ment (s'arrêtait qquand ST valait 1, au lieu d'aller jusqu'< 0). La fonction nyalloc() alloue toujours un nombre pair d'octets (pour Quiter des problines d'alignement), et utrifle qu'on essaye pas d'allouer 0 octets. La fonction LigneSuiv[) w'allouait pas assez de place pour stocker la ligne en cours en cas de trappe (il manquait um octet pour l'octet ml g la fin). Lorsqu'on utilise la requête "so", n'oublie plus de revenir au fichier procodent en fin de fichier. N'oublie plus !' indentation quand une ligne commence par \ !. 1.11 27-Mou-31, 24020 octets La fonction SetMachegs() w'allouait pas assez de place pour arguments des macros (il manquait un octet pour l'octet mul « la les [Erreur #tectoe et corrige grf'ce & l'aide de Michel SCHINZ] Fin)
(.png)
(Express Pd)[!][Amiga-CD32-CDTV].iso/productivity/printing/aroff/aroff.doc/aroff.png)